home *** CD-ROM | disk | FTP | other *** search
/ Games of Daze / Infomagic - Games of Daze (Summer 1995) (Disc 1 of 2).iso / x2ftp / msdos / utils / tmkr11 / docs.txt < prev    next >
Text File  |  1994-11-26  |  12KB  |  346 lines

  1.                         TERRAIN MAKER 
  2.                          Version 1.1   
  3.  
  4.                    Copyright 1994 Eric Jorgensen
  5.  
  6.  
  7.  
  8.                     GENERAL DOCUMENTATION
  9.  
  10. - DISCLAIMER
  11.     Terrain Maker is not a guranteed product.  It has been beta tested by
  12.     about four dozen people, and no one has reported any damage, but there is
  13.     no garuntee that it will not screw everything up and destroy
  14.     someting important like your CPU. So basically,  
  15.     
  16.             *** USE THIS SOFTWARE AT YOUR OWN RISK ***
  17.  
  18.     There.  You have been warned.  I feel much better now.
  19.  
  20.  
  21. - GENERAL INFORMATION
  22.     - What is POV?
  23.         POV stands for Persistance Of Vision.  That is the title of
  24.         a very amazing freeware raytracer.
  25.  
  26.     - what is Terrain Maker?
  27.         Terrain Maker is a landscape editor.  It offers 
  28.         powerful tools for creating and editing all kinds of
  29.         landscapes that can be used as heightfields
  30.         in POV. 
  31.  
  32.     - picture formats and extensions
  33.         Terrain Maker works only with gif (87a spec.) files.  Height
  34.         fields saved by Terrain Maker have the extension .ghf 
  35.         (Gif Heightfield). Terrain Maker can import any image as 
  36.         long as it is in gif format.
  37.  
  38.     - Using the mouse with Terrain Maker.
  39.         Terrain Maker is fully mouse driven.  To activate any
  40.         button on the screen , simply move the mouse cursor 
  41.         over it and click any mouse button once.
  42.  
  43.         To use any of the drawing tools on the heightfield, 
  44.         simply hold down one of the mouse buttons while
  45.         the cursor is in the heightfield work area.
  46.  
  47.     - using slider tools
  48.         Slider tools look like the scrollbars used in many
  49.         Windoze applications.  To use a slider, you can
  50.         press a mouse button while the cursor is on the
  51.         square in the middle of the tool and drag it around
  52.         to change the particular value associated with
  53.         tho tool, or you can click on one of the arrows to 
  54.         change the value by one unit.
  55.  
  56.     - Hot keys.  
  57.         If you see a yellow letter on a button, you can access that
  58.         button by pressing that letter!  YAY!
  59.  
  60.     - Available functions and video memory.  
  61.         Terrain Maker likes to use to two video pages at 800x600x256
  62.         resolution.  This means that your video card
  63.         should have at least 1 MEG of video ram.  Terrain Maker
  64.         will still work on cards with only half that, but
  65.         certain functions will be unavailable.  Specifically,
  66.         these functions are:
  67.  
  68.             pseudo 3D
  69.             undo
  70.             remember
  71.             lava
  72.  
  73.         Note: some video cards do not perform page flipping properly.
  74.         See TROUBLE.TXT for details.
  75.  
  76.     - WINDOWS
  77.         Terrain Maker does not behave well under Windows.  Exit
  78.         to DOS before you use it.
  79.  
  80. - MAIN MENU
  81.     The main menu is the springboard for all of Terrain Maker's
  82.     functions.  These are the controls you will find on the main
  83.     menu along with descriptions of what they do:
  84.  
  85.     - GENERATE
  86.         This will be the starting place for most of your
  87.         lanscape projects.  The generate button spawns
  88.         the random landscape engine which will fill
  89.         the entire buffer with a random landscape based
  90.         on the parameters set from the main menu.
  91.         (See "density" and "smoothness" sliders below)
  92.  
  93.     - TEST
  94.         This functions exactly like "generate" except that
  95.         it only uses 1/16 of the buffer.  This is so you
  96.         can get an idea of what the generated terrain
  97.         will look like without having to render the entire
  98.         buffer.
  99.  
  100.     - LOAD
  101.         This allows you to load a heightfield from the
  102.         disk.  When you press this button, Terrain Maker searches
  103.         for any heightfields (.ghf extension) in the current 
  104.         directory, then creates an individual button for each one 
  105.         of them. When you press a button, that particular heightfield
  106.         will be loaded into memory.  When you have finished 
  107.         choosing the one you want, simply click on the "done"
  108.         button.  
  109.  
  110.     - SAVE
  111.         This allows you to save the currently displayed
  112.         height field.  You will be prompted for an 
  113.         eight character (or less) filename.  Terrain Maker
  114.         will automatically add a ".ghf" extension.
  115.  
  116.     - MODIFY
  117.         This brings up the "modify heightfield" menu. (See
  118.         next section.) This allows you to perform various
  119.         editing features on the terrain.
  120.  
  121.     - PSEUDO 3D
  122.         This function activates a menu which allows you to view
  123.         a 3-D image of the current heightfield in color and from different
  124.         angles.
  125.  
  126.     - IMPORT
  127.         This button allows you to load any gif file into the
  128.         heightfield buffer.  Terrain Maker looks for gif files
  129.         (.gif extension) in the current directory and creates
  130.         a button for each file.  When a button is pressed, 
  131.         a frame pops up which you can move around on the screen.
  132.         when you have picked the spot where you would like the     
  133.         gif to be placed, click any mouse button once.  Terrain
  134.         Maker will then place the image and convert intensity
  135.         values to height values.  (Black = 0 altitude, White =
  136.         Highhest altitude.   This can produce some interesting
  137.         effects if you use photographs.)
  138.  
  139.     - COLOR MAP
  140.         Many people use the heightfield gif for a texture map as
  141.         well.  The color map editor allows you to change the
  142.         colors of your heightfield to look like different 
  143.         landscapes.  
  144.  
  145.     - QUIT
  146.         Guess what happens when you press this button?
  147.  
  148.     - parameters
  149.         There are three parameter sliders avaiable from
  150.         the main menu.  These are used to affect some of the
  151.         buttons on the main menu:
  152.  
  153.         - DESITY
  154.             This parameter controls how close together
  155.             The mountains are when the heightfield is
  156.             generated.  A very low density will 
  157.             cause a smooth transition from corner 
  158.             to corner.  A Very high density will
  159.             generate something that looks like a 
  160.             satellite view of the Alps.
  161.  
  162.         - SMOOTHNESS
  163.             This parmeter controls the point-to-point
  164.             variation of the landscape generator.  A
  165.             very low smoothness will cause the lanscape
  166.             to have lots of bumps and wrinkles.  A very
  167.             high smoothness generates an even,
  168.             sloping Terrain Maker.  
  169.  
  170.             Because if the way the land generation algorythm is 
  171.             set up, smoothness has a mild inverse relationship
  172.             with density.  (ie: lowering smoothness tends to increase 
  173.             density.)
  174.  
  175.         - SEA LEVEL
  176.             This slider simply controls where the pseudo
  177.             3D function clips the heighfield for a 
  178.             simulated ocean effect.  When you use this 
  179.             slider, Terrain Maker highlights the heightfield
  180.             to show you exactly where the cut will take place.
  181.  
  182.     - Locating coordinates
  183.         While in the main menu, you can click on the height field
  184.         buffer to locate specific coordinates.  Terrain Maker
  185.         shows two sets of coordinates on the bottom of the screen:
  186.         The first set are absolute coordinates- X,Y,Altitude.
  187.         The second set are coordinates that POV uses for heigtfields.
  188.  
  189. - MODIFICATION MENU
  190.     The modification menu provides access to all of the landscape 
  191.     modification tools in Terrain Maker.  
  192.  
  193.     - tools
  194.         The upper left grouping of buttons on the modification 
  195.         menu are the tools that you can use.  To select a tool,
  196.         simply press the button with it's name.  Terrain Maker
  197.         higlights te tool to indicate that it is in use. 
  198.         
  199.         All tools are affected in some way by the four parameters 
  200.         (see below) that are represented by sliders on the lower 
  201.         half of the modify menu.
  202.  
  203.         All tools are available in paint mode, but only some are
  204.         available in "do all" mode.  Thhe tool descriptions below
  205.         will indicate which ones these are.
  206.  
  207.         Here is a listing of available tools and what they do:
  208.         
  209.         - smooth
  210.             This tool smooths out altitude variations in the
  211.             heightfield.
  212.  
  213.         - raise
  214.             This tool raises the altittude of eightfield points.
  215.  
  216.         - lower
  217.             Opposite of Raise.
  218.  
  219.         - erode
  220.             This tool simulates erosion by moving a point "downill"
  221.             and subtracting altitude as it goes.  These "raindrops"
  222.             are spawing randomly withing the circle define by the 
  223.             brush shape. This function does not work in "do all" mode.
  224.  
  225.         - level
  226.             This function pushes altitude values toward the level
  227.             indicated by the level slider.  (ie:  if the level in the
  228.             level slider is 100, values below 100 will be raised
  229.             and values above 100 will be lowered.)
  230.  
  231.         - rough
  232.             This function randomly displaces the altitude of points 
  233.             in the heigtfield.
  234.  
  235.         - lava
  236.             This creates long blobby shapes that go downhill. Does not
  237.             work in "do all" mode.
  238.  
  239.         - dirt
  240.             This works like the erode function, except that Terrain
  241.             Maker randomly sprinkles "dirt" instead of "raindrops".
  242.             The dirt particles roll downhill and generally come to rest in
  243.             pits and crevices.  Doesn't work all that swell.  Doesn't 
  244.             work in "do all" mode.
  245.  
  246.         - paint
  247.             Quick and dirty altitude adjustment.  Paints whatever
  248.             level is indicated by the level slider onto the
  249.             heightfield.  Use this tool in "do all" mode to clear 
  250.             the landscape.
  251.  
  252.         - expand
  253.             opposite of level.
  254.  
  255.     - using tools
  256.         Using tools is very simple.  Once you have selected a tool,
  257.         you can use it in paint mode simply by pressing and holding
  258.         down the mouse button wile the cursor is in the heightfield
  259.         buffer.
  260.  
  261.         Or you can press the "do all" button and apply the tool to
  262.         the entire landscape.  (Some tools do not work in "do all"
  263.         mode. See tool descriptions above.)
  264.  
  265.     - undo
  266.         Terrain Maker keeps a copy of te current heightfield on the second
  267.         video page. (If it exists)  Pressing the undo button copies
  268.         the heightfield from the second page to the first page, 
  269.         effectively undoing any changes to the image. Your video card 
  270.         must support page flipping in order use this function.
  271.  
  272.     - remember
  273.         Remember is the opposite of undo:  it copies te heigtfield from
  274.         the first (visible) page to the second page.  This will make
  275.         permanent any changes you have made to the image.
  276.  
  277.     - do all
  278.         As explained above in [using tools], the "do all" button applies
  279.         the current tool to the entire landscape.
  280.  
  281.     - invert
  282.         Destruction of biblical proportions.  Mountains become valleys
  283.         and valleys become mountains.  That kind of stuff.
  284.  
  285.     - parameters
  286.         There are four parameters available to you that allow you to
  287.         alter the behavior of the modification tools.  Only a few
  288.         tools are sensitive to all four parameters.
  289.  
  290.         - brush size
  291.             This is basically the area of affect for the tool when
  292.             used in paint mode.  The graphic next to this tool
  293.             indicates the exact size the brush will be.
  294.  
  295.         - brush intensity
  296.             This controls the magnitude of the effect  of most tools.
  297.  
  298.         - brush rate
  299.             This controls how rapidly the tool is applied when in paint
  300.             mode.  Setting the brush rate to 1 puts the current tool in
  301.             single step mode.
  302.  
  303.         - level
  304.             This is the numerical value used by tools that need to
  305.             refernce a particular altitude. (ie:  paint and level)
  306.  
  307. -THE COLOR EDITOR
  308.     When you select the color editor, you will see the windows with 
  309.     graphs idicating the intensities of Red, Green, and Blue 
  310.     component colors in the palette, plus some miscellaneous buttons. 
  311.     
  312.     - Editing component colors
  313.         To edit a color, simply click the mouse on one of
  314.         the graphs and "paint" new values.
  315.  
  316.     - Smooth button
  317.         Pressing this button averages colors locally to smooth
  318.         any steps in the palette.
  319.  
  320.     - Save button
  321.         Pressing this button lets you save the current colormap
  322.         rgb values in a text file.  (extension .rgb
  323.  
  324.     - Load button
  325.         This lets you import a colormap from an rgb file, gif, or 
  326.         heigtfield.  To select the import source, click the 
  327.         appropriate radio button: RGB, GIF, or GHF.
  328.  
  329. -PSEUDO 3D MENU
  330.     - View From:
  331.         Each of these four buttons will generate a 3D rendering
  332.         of the heightfield buffer.  The placement of the "camera" 
  333.         depends o which button you push: To the TOP, BOTTOM, LEFT
  334.         or RIGHT.
  335.  
  336.     - Sea Level
  337.         This slider allows you to control the altitude where the
  338.         heightfield is "clipped" and turned into water.
  339.  
  340.     - Height Scaling
  341.         This slider controls the verticle scaling that the "View From" 
  342.         buttons use to render the heightfield. 0 = flat. 100 = pointy.
  343.  
  344. - TROUBLESHOOTING
  345.     Please see the file TROUBLE.TXT for information on troubleshooting.
  346.